Novelang

The electronic document generator

HTTP daemon

Novelang HTTP daemon runs as a Web server and displays documents in a Web browser.

It starts like this:

java -jar $NOVELANG_HOME/lib/Novelang-bootstrap-$VERSION.jar httpdaemon [options]

The --port option

The --port option sets the TCP port of which the daemon listens to:

--port=8083

Then URL for accessing documents becomes something like:

http://localhost:8083/mydocument.html

The --serve-remotes option

The --serve-remotes option enable serving document for other computers (computer with an IP address which is not 127.0.0.*). It is not recommended to activate this option because Novelang is not architectured yet to run as a Web server serving many concurrent requests.

--serve-remotes

Default value is false.

The --content-root option

The --content-root option sets the base directory to another value than current directory:

--content-root=../my-source/documents

The --temporary-dir option

The --temporary-dir option sets where Novelang writes its log files.

--log-temporary temporary-files

Default value is $temporary$.

The --log-dir option

The --log-dir option sets where Novelang writes its log files.

--log-dir logs

Default value is current directory (the value of user.dir system property).

The --font-dirs option

The --font-dirs option sets multiple directories where Novelang looks for fonts.

--font-dirs my/fonts-1 /Users/Shared/Fonts

The --style-dirs option

The --style-dirs option sets multiple directories where Novelang looks for stylesheets and related resources. See chapter about stylesheet for details.

--style-dirs my/styles-1 /Users/Shared/Fonts

The --hyphenation-dir option

The --hyphenation-dir option sets where Novelang should attempt to load hyphenation files from.

--hyphenation-dir my/directory

The --source-charset option

The --source-charset option sets the charset of source documents.

--source-charset MacRoman

Default value is UTF-8.

The --rendering-charset option

The --rendering-charset option sets the charset of rendered documents.

--rendering-charset iso-8859-2

Default value is UTF-8.

Directory listing

You can list the content of a directory by not giving any document name.

This will list every file ending by document source extension (currently “.novella” or “.opus”), including those in subdirectories. Every subdirectory also appear, even if it contains none of those files. Document sources become hyperlinks to their HTML form.

Here are samples of valid URLs for directory listings:

http://localhost:8080
http://localhost:8080/
http://localhost:8080/samples
http://localhost:8080/samples/

Because of a known Safari bug, Safari browsers get redirected to a fake page named -.html but the feature remains the same, however.